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* 

* FUNCTION NAME « wUserFgndS tMode 
* 

* DESCRIPTION 

* Save client machine CPU r gister state 

* Sav video BIOS ./lata area 

* Setup a VGA (or possibly VESA) BIOS call to set tne current 

* client video mode in order to restore the VDM's state. 

*******************************************************•*******************/ 

wUserFgndSetMode( ) 
{ 

/* Mew art */ 

Save client CPU register state 
save video BIOS data area 

setup VGA (or possibly VESA) BIOS call to set the current 

client video mode 
return to 

wUserFgndLogicalLineLength 

> 

/********************* ****** ************ ****************** ***************** 
* 

FUNCTION NAME «= vvUserFgndLogiealLineLength 

* 

* DESCRIPTION 

* Setup a VESA BIOS call to se+ tk*. ie^ic«.\ £can lfne,\e^a^\ 

* Useful for VESA BIOS not implementing full register restore. 
* 

************** ******** ************************************************* ***** / 

wUs rFgndLogicalLineLength( ) 
{ 

/* New art */ 

inj ct vesa call to restore 

logical scan length start registers from saved area 
return to 

vvUserFgndDisplayStart, 

> 



FUNCTION NAME « vvUserFgndDisplayStart 



/*********** ************************* ********************************* ****je*~. 
* 
* 
* 

* DESCRIPTION 

* Setup a VESA BIOS call to £<tv 4*v^ dispUj ^rSf^cs 

* inserts the int 10 instruction , and arms a return to 

* wUaerFgndBankCopy. 
* 

************************************* *************************************** f 

wUserFgndDisplayStart( ) 
{ 

/* New art */ 

inject vesa call to restore display start registers from saved area 
return to 

vvUserFgndRegsS t, 

/************************************** ******************* ************** 
* 



i< — ^ 
^ — ~ 



* FUNCTION NAME = w srFgndRegsSet 
* 

* DESCRIPTION 

* Setup a VESA BIOS call to restor the clients adapter registers 

* if***** ********************************** 

vvUserFgndRegsSet( ) 
{ 

/* New art */ 

inject vesa call to restore client adapter registers from saved area 
r turn to 

vvUserFgndBankSetlst, 

} 

/****************************************************************** ******* 
* 

* FUNCTION NAME = wUserFgndBankSetlst 
* 

* DESCRIPTION 

* Setup a VESA BIOS call to set the VRAM bank number to 0; 
* 

******* *********************************************************** ; ** 1kr ^^^ 1t ^ + ^ 

vvUs rFgndBankSetlst( ) 
{ 

/* New art +/ 

if( Mode uses Linear Frame Buffer ) 

transfer LINEAR buffer contents to VRAM from saved area 
inject vesa call to set A Bank to saved A bank 
return to 
vvUserFgndBankBSet, 

else 

pvd->VdmUser,lBankCopyNextBank =0; 

inject vesa call to set A Bank to next bank # for restore 
return to 

wUs erFgndBankCopy Se t BBank , 

} 

/*************************** *********************************************** 
* 

* FUNCTION NAME = vvUserFgndBankCopySet BBank 
* 

* DESCRIPTION 

* Set the B Bank Window if it is needed for read/write operations. 

* Most adapters only have an A Bank. 

* A few have an A Bank for reading and a B Bank for writing, 

* or vice versa. 
* 

******* ******************************************************** ***********^ 
vvUserFgndBankCopySetBBank( ) 
/* New art */ 

inject vesa call to set B Bank to next bank # for restore 
return to 

vvUs erFgndBankCopy , 

/******************************* ************ ************************ ****** 
* 

* FUNCTION NAME = wUs erFgndBankCopy 
* 

* DESCRIPTION 




* Transfers vlr«-iai memory to the VHAM DanK, 
and then sett a. VESA BIOS call to access t next A bank. 

* On the last pass, it does the transfer of virtual memory to the VRAM 

* bank, and then setup a VESA BIOS call to set the bank 

* number to the clients current A bank number. 

******************************************** **^^ 

vvUserFgndBankCopy ( ) 
{ 

/* Prior art */ 

transfer one (current) bank of VRAM from saved area 
/* New art */ 
increment bank number 
iff copy bank < total banks ) 

inject: vesa call to set A Bank to next bank # for restore 

return to 

vvUserFgndBankCopySetBBank , 

lse 

inject vesa call to set A Bank to client bank # 
return to 

vvUserFgndBankBSet , 

} 

/******************************************^^ 
* 

* FUNCTION NAME = vvUserFgndBankBSet 
* 

* DESCRIPTION 

* Setup a VESA BIOS call to set the B bank 

* number to the clients current bank number. 

* Most adapters only have an A Bank* 

* A few have an A Bank for reading and a B Bank for writing, 

* or vice versa. 

* Useful for VESA BIOS not implementing full register restore. 
******************** w** ******** **************** 



vvUserFgndBankBSet { ) 

* inject vesa call to set B Bank to saved bank # 
return to 

vvUserFgndRegsSetAtEnd, 

} 

/***************************** ***********************^^ 
* 

* FUNCTION NAME = vvUserFgndRegsSetAtEnd 
* 

DESCRIPTION 

* Setup a VESA BIOS call to restore the client adapter 

* register set to clean up the registers changed 

* during the restoring the VRAM banks. 
* 

**************************************************************** 



r 



vvUserFgndRegsSetAtEnd ( ) 

* inject vesa call to restore registers from saved state 
return to FgndFinish 

} 

I ***************************************************** **********************. 



* FUNCTION NAME - vv. ^rFgndFinish 

* • 

* DESCRIPTION 

* Finish foreground switch in VDM's context. 

* Restore the VGA register state directly* 

* Useful for VESA BIOS not implementing full register restore, 
+ Restore client machine CPU register state sav d 

* Restore video BIOS data area sav d 

* Switch trapping behavior to transparent real hardware access. 
* 

************************************************ ***************^ 
wUserFgndFinish( ) 

* /* Prior art */ 

restore VGA register state 
/* New art */ 

restore client machine CPU register state saved 
restore video BIOS data area saved 
/* Prior art */ 

switch trapping behavior to transparent real hardware access 
thaw VDM when in unemulatable (SVGA) video mode. 

} 




* FUNCTION NAME « vvUserBgndSaveSizeQuery 

* DESCRIPTION 

* Save the VGA register state directly. 

* Useful for VESA BIOS not implementing full register save. 

* Save client machine CPU register state 

* Save video BIOS data area 

* setup a VESA BIOS call to get the clients SVGA regs save area size, 
* 



************************************************ 
vvuserBgndSaveSizeQuery( ) 

* /* New art */ 

Save client machine CPU register state 
Save video BIOS data area 

inject VESA BIOS all to get client SVGA regs save area size 
return to 

vvUs erBgndRegsGe t , 

> 

/************************************************************************ 
* 

* FUNCTION NAME « vvUserBgndRegsGet 
* 

* DESCRIPTION 

* Checks the SVGA regs save area size returned. 

* If the DOS allocated save area is large enough, 

* then it issues the VESA BIOS call to save the SVGA registers^ 

* Setup a vesa BIOS call to save adapter register state* 
* 

******************************************************************* *******4*/ 

wUserBgndRegsGet( ) 
{ 

/* New art */ 

Setup a VESA BIOS call to save adapter register state. 




****/ 



) 



<\Pe 



return to 

vvUs erBgndLo ;a lLi neLengt h , 

> ' 



/*************************************** ************************ ***********^- 

* FUNCTION NAME ■ VvUserBgndLogicalLineLength 
* 

* DESCRIPTION 

* Setup a VESA BIOS call to get the clients VRAM bank number. 
********************************** f 



VvUserBgndLogicalLineLength ( ) 
{ 

/* New art */ 

S tup a VESA BIOS call to get the clients VRAM bank number, 
return to 

vvUserBgndDisplayStart/ 

} 

/****************************************************** ******************** 

* FUNCTION NAME « vvUserBgndDisplayStart 
* 

* DESCRIPTION 

* Save returned logical line length values ♦ 

* Setup a VESA BIOS call to get the clients display start offset. 
**************************************************************************** 

vvUserBgndDisplayStart ( ) 
{ 

/* New art */ 

Save returned logical line length values. 

Setup a VESA BIOS call to get the clients display start offset, 
return to 

wuserBgndBankGet , 

> 

/****** ****** *************************************************************_^. 
* 

* FUNCTION NAME = wuserBgndBankGet 
* 

* DESCRIPTION 

* Save returned display start values. 

* Setup a VESA BIOS call to get the clients VRAM A bank number. 
* 

**************************************** ************************************ f\ 



wuserBgndBankGet ( ) 
{ 

/* New art */ 

Save returned display start values. 

S tup a VESA BIOS call to get the clients VRAM A bank number . 
return to 

vvUs er BgndBankBGe t , 

} 

/**************************************** ******************** ***********^*j 
* 

* FUNCTION NAME = vvUserBgndBankBGet 
* 

* DESCRIPTION 




* Save returned ** bank number* 

* ■ setup a VESA . JS call to get the clients \ 4MB bank number. 

*. 

*********** ************ ***************************** 

vvUserBgndBankBGet( ) 
{ 

/* New art */ 

Save return d A bank number, 
set current copy bank to -1 

Setup a VESA BIOS call to get the clients VRAM B bank number, 
return to 

vvUserBgndBankCopy 

j /*§V4.0JAN01*/ 



/**************************************** ************* ******************** 
* 

* FUNCTION NAME = vvUserBgndBankCopy 



1 



* DESCRIPTION 

* On the 1st pass, 

* Save returned client B bank number. 

* Setup a VESA BIOS call to set the VRAM bank number to 0. 
* 

* On all middle passes, 

* Tranfers the VRAM bank to virtual storage, 

* Setup a VESA BIOS call to access the next VRAM bank* 
* 

* On the last pass, 

* Transfers the last VRAM bank to virtual storage, 

* Setup a BIOS call to set VGA mode via vvUserBgndVGAModeSet 
* 

********************************************************** 

vvUserBgndBankCopy ( ) 

* /* New art */ 

if( copy bank < 0 ) 

save returned client B bank number 
else 

/* Prior art */ 

transfer one VRAM bank to saved area 
/* New art */ 

if ( mode uses Linear Frame Buffer ) 

transfer whole linear buffer to save area 
return to 

vvUserBgndVGAModeSet 

else 

increment copy bank number 
if ( copy bank number < total banks ) 

setup a VESA call to set copy A bank number. 

return to 

wUserBgndBankCopySetBBank, 

else 

call vvUserBgndVGAModeSet directly 

} 

/******************************************************************** ***** j ** i 
* 

* FUNCTION NAME « wUserBgndBankC pySetBBank 
* 

* DESCRIPTION 

* setup VESA BIOS call to set the copy B Bank window, 

* if it is needed for read/write operations. /h / « 



- ******************** ********************* ****** ************************,. 

wus rBgndBankCopySetBBank( ) 
< 

/* New art */ 

Setup VESA BIOS call to set the copy B Bank Window, 
return to 

wUserBgndBankCopy 

/******************************************************** 

* FUNCTION NAME = wUserBgndVGAModeSet 
* 

* DESCRIPTION 

* Setup a VGA BIOS call to set a VGA standard video mode (mode 12). 

* This allows next operating system component manipulating the 

* video hardware to assume the SVGA is a simple/standard VGA* 

********************************************************************* 
wUserBgndVGAModeSet < ) 
/* New art */ 

setup a VGA BIOS call to set a VGA standard video mode. 
^ return to wUserBgndFinish 0JAH01*/ 

/********************************************************************* ****>■*--- 
* 

* FUNCTION NAME - wUserBgndFinish 
* 

* DESCRIPTION 

* Finish background switch in VDM's context 

* Freeze VDM when in unemulatable (SVGA) video mode. 

* Leave emulateable (VGA) video mode unfrozen, 
* 

**************************************************************************/ 



Alb 





vvUserBgndFinish( ) 

* /* New art */ 

restore client CPU register state 
/* Prior art */ 

switch trapping behavior to emulation of hardware access 
freeze VDM when in unemulatable (SVGA) video mode. 

} 
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/******* ************ ** *********************** *v ************************ 
* 

* FUNCTION NAME « wlnit 
* 

* DESCRIPTION 

* Initialization for virtual video driv r 

* called by mvdm at start of each VDM 

* Most VESA BlOSes now provide PCI BIOS information too 

* 

************************* ************** *************************************/ 
vvlnit() 

{ /* Prior art; */ \ 
register standard VGA I/O port address handlers with mvdm. 
/* New art: */ 

make PCI BIOS call to get list of PCI BIOS I/O port addresses, 
for each PCI BIOS I/O port address 

register PCI BIOS I/O port address handler with mvdm. 

> 



J /*************************************************************************** 



;* FUNCTION NAME « mvdmlOHook 
;* 

;* DESCRIPTION 

•* All client I/O instructions generate a hardware trap which comes here 

;* Handlers are generally all registered at the start of the VDM. 

j* Video port hooking is enabled in the background, 

;* and disabled in the foreground. 

;* Non-video hardware follows other algorithms based on the 

;+ device driver requirements and sophistication. 

} * 

j *************************************************★*************************/ 

mvdmPortI0Hook( ) ' 
i MOX 
/* All prior art */ 

if( registered handler for I/O port address 
&& hooking enabled for I/O port address ) 
call registered handler for I/O port address 
else 

do I/O directly. 

} 

/*************************************************************************** — — J 
* 

* FUNCTION NAME - wVGAStandardPortlOHook 
* 

* DESCRIPTION 

* Typical registered hook handler for VGA Standard I/O port address 

* May be more complicated if I/O port not connected to a simple register 

* Such as pair of I/O ports for an index and data register array 

* Each I/o port address may have its own unique and differently 

* coded handler to handle unusually behaving ports. 

**************************************************************************** f 

WVGAStandardPortlOHook ( ) 
{ 

/* All prior art */ \ iWf 

if( input ) 

return ( emulation state variable value for I/O port address ) 



7 



} 



) 

/* This go s into he client CPU r gister set * 
Is /* output */ 

Save output from client CPU regist r set /#a^ - 

into mulation state variable for I/O port address |f°r 
/* Will be used later to r store adapter contents */ 

Adjust any other emulation state variables required by changes to this portl 



/************************************** ************************** ********** 

* 

* FUNCTION NAME « wVGADataPortlOHook 
* 

* DESCRIPTION 

* Typical registered hook handler for VGA Data I/O port address 

* as a part of index and data port handler pair. ~ ^ V 

* Index port handler is usually a vvVGAStandardPortlOHook. 
* 

************************** ************************************************** f 

wVGADataPortiOHook( ) 
{ 

/* All prior art */ 
if( input ) 

return ( emulation state variable [index port state variable] 

value for I/O port address ) 
/* This goes into the client CPU register set */ 
else /* output */ 

Save output from client CPU register set 

into emulation state variable [index port state variable] 

for i/o port address 
/* Will be used later to restore adapter contents */ 

Adjust any other emulation state variables required by changes to this port 

} 

/*************************************************************************** _ 

* FUNCTION NAME = vvPCIPortlOHook 
* 

* DESCRIPTION 

* Registered by the virtual video device driver tor a list 

* of port addresses provided by the PCI BIOS. 

* ONLY registered hook handler type for PCI BIOS I/O port address. 

* This represents a simple best guess to how a typical port works. 

* But it often does not absolutely correct emulation. 

* However it almost always suffices for emulating VGA modes. \^ 

* This is NOT true of SVGA modes, 

* and this is why we freeze when in VESA modes in the background 

* so that the video adapter is not incorrectly emulated. 

* Emulation state variables used here 

* will NOT be used later to restore adapter contents, 

* because we do not know how port really works! 

* Instead we rely on the VESA BIOS calls to restore important registers. 
* 

***************************************************** *********************** / 

vvPCIPortlOHookO 
{ 

/* New art */ 
if( input ) 

return ( emulation state variable value for I/O port address ) 
/* This g es into the client CPU register set */ 
else /* output */ 

save output from client CPU register set 

into emulation state variable for I/O port address 



/******************* **************' *********** £\ ************************* 

;* 

;* FUNCTION NAME * VVlntlOPreHOok 

;* 

;* DESCRIPTION 

;* Quick Return if not Mode Set, 

;*' else tranfer contr 1 to 

;* 

; **** *****************************************************★***************/ 

vvIntlOPreHook( ) 

if( AH( pcrf ) 0x00) /* VGA Mode Set */ 
{ 

/* prior art */ 

save client registers as last setmode registers 
vvlntlOChain 

else if( AX( pcrf ) 0x4F02 ) /* VESA Mode Set */ ^ 
/* Prior art */ 

save client registers as last setmode registers 
/* From here begins new art: */ 
save VESA eetmode number 
push client registers 

inject VESA call to get VESA BIOS SVGA INFO, 
return to wlntlOVesaVbelnf oReturn 

} 

else 

/* Prior art */ 
vvlntlOChain 

} 

/***************** ********************************************************** 
* 

* FUNCTION NAME - WlntlOVesaVbelnf oReturn 
* 

* DESCRIPTION 

* sets up for a VESA Mode query. 
* 

****************************************************************************/ 
wlntlOVesaVbelnf oReturn( ) » 

* save VESA BIOS SVGA INFO including total VRAM size, 
inject VESA BIOS call to get MODE INFO for new mode, 
return to 

w I nt 1 OVes aModet n f oReturn 

} 

/*************************************************************************** 
* 

* FUNCTION NAME * wlntlOVesaModelnf oReturn 
* 

* DESCRIPTION 

* Gets the VESA mode information from the Mode information block and 

* copies it to the VDM's VESA mode information structure/ and then 

* sets up to do the actual VESA BIOS mode set to the VESA mode, 
* 

****************************************************************************/ 



VOID HOOKENTRY wlntlOVesaModelnf o»*fcurn( } 



OA- 



pop client registers 

save current mode into as old mode Info 
save VESA BIOS MODE INFO as current mode info 

( includes mode dimension info ) 
inject original setmode call to original VESA BIOS INT 10 handler ^ 
return to ' 

vvlntlOV saEndReturn 

> 

/************************ ************************ ************************** 

* " 

* FUNCTION NAME = wlntlOVesaEndReturn 
* 

* DESCRIPTION 

* Does the post cleanup after the VESA BIOS mode set, 
*********************************************************************** 

WlntlOVesaEndReturn ( ) 

^ if { AX( pcrf ) != VESA_FUNCTION_SUCCESS ) !^ 6 ^ 

restore current mode info from old mode info 
else if( background ) 

freeze VDM 
wlntlOContinue 

} ^ 

/*************************************************************************** 
* 

* FUNCTION NAME * wlntlOChain 

* A <^ 

* DESCRIPTION \ lO * 

* continue with client INT 10 f N — » 
* 

****************************************************************************/ 
vvIntlOChain< ) 

* call original (VGA/ VESA) BIOS INT 10 handler 
return to wlntlOContinue 

> 

/*************************************************************************** 
* 

* FUNCTION NAME = wlntlOContinue 
* 

* DESCRIPTION 

* return to client program 
* 

****************************************************************************/ 
vvlntlOContinue( ) # 

return to client program (^J(^ 

} 

/*************************************************************************** 
* 

* FUNCTION NAME - wDsvModeUpdate 
* 

* DESCRIPTION 

* Determine current mode dimensions 

* Thes dimensions ar us d to determine: 



* A) How much v r \M to sav and restore for e' lation switching 

* n B) How to drt current VRAM contents as a L cture in a desktop window 
* 

****************** **** ****** ************************************** *******^ y 

vvDsvModeUpdate ( ) 
{ 

if ( VESA MODE ) 
/* New art J */ 

calculate mode dimensions from info returned by previous VESA calls 
(current mode info) 

else 

/* Prior art */ 

calculate mode dimensions from standard VGA registers 



